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GENKl^L INFORMATION 


This document provides a plan for testing of software developed 
for the Remote Sensing Information Subsystem (RSIS) as it applies 
to the Texas Natural Resources Information System (TNRIS) . This 
system provides capabilities for the processing of remotely 
sensed Landsat data, the handling of geographic information, the 
preparation of information assessment routines and the displaying 
of the processed data on an interactive CRT terminal screen. The 
complete RSIS system constitutes an interactive system for the 
screening of Landsa-c data, area-of -interest determination, data 
classification, and display for analysis. 

Specific constraints of the system center around the use of the 
Detection and Mapping software for subsystem control and the use 
of ISOCLS/ELLTAB for classification of image data. The RSIS 
software as designed uses raw Landsat data from tape, density 
and radiance data files, and class files output from the existing 
ISOCLS/ELLTAB modules as input to the software modules being 
tested. 

The RSIS subsystem phase "A" provides the following functions. 

a. Reading raw data from Landsat in the old CCT format. 

b. Obtaining classification results from radiance or detection 
files created by the processing of TEXAS' ISOCLS/ELLTAB 
classification programs. 

c. Obtaining radiance and density detection files from the 
DAM package program CLASSIFY. 

d. Contrast stretching or contracting of the range of radiance 
values of an image. 

e. Band or channel ratioing. 
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f. Applying geometric corrections as determined from control 
points selected by the analyst analogous to current use of 
the Detection and Mapping package. 

g. Applying either a gradient or Laplacian sharpening filter to 
the data to enhance the image. 

h. Image enhancement by selection of hue and intensity of colors. 

i. Changing color assignment data. 

j . Reduction of a displayed area of interest by deletion of 
pixels or lines. 


OVERVIEW OF ACCEPTANCE TEST 


The Acceptance Test will be conducted in three phases. The first 
phase is a CLASSIFICATION TEST of a pre-determined area via an 
ISOCLS/ELLTAB batch run to be performed by TNRIS personnel on the 
Univac 1100/41 at Austin, Texas. Output from this run will be 
loaded into a class detection file in ELLTAB format as defined 
in document (LEC 14201) . The DAM package programs CONTROL and 
CLASSIFY must also be run by TNRIS personnel for the same scene. 

These programs will provide density detection files and registration 
parameters for subsequent use by RSIS programs. The second phase 
will consist of complete exercise of the RSIS software resident in 
the Univac in the UNIVAC SOFTWARE TEST. Two test series will be 
conducted, a functional test and a working environment test. The 
third phase v;ill be the IIGS SOFTWARE TEST of software resident on the 
INTERDATA 7/32 and RAMTEK display system. 

CLASSIFICATION TEST 

TNRIS analysts will validate the classification results generated 
by ISOCLS/ELLTAB. Density detection files generated by CONTROL 
and CLASSIFY will be validated by TNRIS analysts through use of 
the PRTCLASS program. The Landsat data used by these runs and 
by RSIS programs will constitute the test data for the entire 
Acceptance Test described in this document. 

UNIVAC SOFTWARE TEST 
Functional Test 

There will be one functional test performed to exercise all 
modules in RSIS UNIVAC software. The purpose of this test is 
to determine if all modules function in a normal manner. TNRIS 
analysts will provide Landsat, detection file and ELLTAB class 
data. TNRIS analysts will work from a computer terminal, exercising 
the various user options of RSIS in order to exercise all major 
modules inteiractively . Further instructions for running this test 
are provided in Table 1. 
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Working Environment Test 


This test will exercise the RSIS in its working environment. 
Further explanations and procedures are described in Table 2. 

IIGS SOFTWARE TEST 

TNRIS analysts will run IIGS software with a display tape provided 
for the purpose. This tape will contain standard color and image 
files which will be loaded into the INTERDATA 7/32 for use during 
the IIGS SOFTWARE TEST. Procedures for saving a color file and 
an image file after display of the preliminay window on the color 
graphics can be found in the IIGS INTERIM INTERACTIVE GRAPHICS 
SUBSYSTEM USER'S GUIDE. 


IIGS software will receive as input for the acceptance test a 
tape created by the RSIS Univac software during the vvorking 
environment test. This tape contains all the information con^* 
earning each display or map generated by RSIS UNIVAC software. 

The IIGS will display these windows on the RAMTEK color graphics 
display device. Procedures for displaying the various windows stored 
on the RSIS Univac software output tape on the RAMTEK color 
graphics CRT will be found in the RSIS INTERIM GRAPHICS SUBSYSTEM 
user's GUIDE. 


IIGS software will also output cursor coordinates; make changes 
to the video lookup table ; change the colors appearing on the 
screen; produce a color table report; output the contents of the 
video lookup table to a standard color file on disk; output 
the contents of an image data file to disk; and will output an 
image data file on tape similar to the tape output by the RSIS 
UNIVAC software. This tape file can be read by the IIGS and 
produce a color display similar to displays generated from the 
RSIS univac software tape. All the above mentioned features of 
the IIGS will be exercised by TNRIS analysts. Procedures for exer- 
cising these options will be found in the RSIS INTERIM GRAPHICS 
SUBSYSTEM USER'S GUIDE. 
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PART I 


RSIS ACCEPTANCE TEST PROCEDURES 


UNIVAC SOFTWARE 


TABLE 1 


UNIVAC SOFTWARE FUNCTIONAL TEST INSTRUCTIONS 


To bring up the RSIS UNIVAC software on the UNIVAC series 1100 computer, follow 
the system generation procedures outlined in DAM package Appendix K. 


Below are listed the UNIVAC control language commands and RSIS commands necessary 
to exercise all RSIS UNIVAC software modules. 


@RUN run-id, accounting-information, qualifier 
@ASG,A RSIS-program-file-name. 

@USE DAM. , RSIS-program-file-name. 

@ASG,T 2., 16N, reel-number 

This tape is used for output to Interdata/Ramtek display 
@REWIND 2. 

@USE 25. ,qualifier*filename. 

ELLTAB class file for the first strip 

@ASG,A 25. 

@ASG,T 3., 16N, reel-number 

Landsat tape for first strip 

©REWIND 3. 

©ADD DAM. SETUP 


Table 1-a 


PART A 


CLRTAB 

1. To test most of the modules used in the output of CRT color displays 
the following execution is done. 


@XQT CLRTAB MODULES EXERCISED 

CLRTAB 2 . 7 

CLRXQT 2.7.1 

CLROOO 2.7.2 

RSIS COMMANDS 


OVERALL DEFAULT COMMANDS 

ON , CONFIRM , LEGEND , PROMPT , , CRT , RES , 511 , 511 , , CRT , 
SCREEN, 19 

SATURATION, 62 COLOR CHANNEL, 31 INTENSITY CHANNEL 

INTENSITY, 0 1ST FACTR, 0 LOW VALUE, 100 2ND FACTR, 

31 HIGH VALUE 

GRAPHICS, DELETE 

***NOTE: DELETED COLOR FILE AND IMAGE FILE NAMES 
WINDOW, PRINT, 

-255 LINE, -255 COLUMN, 

255 LINE, 255 COLUMN 
SPACING, 1 LINE, 1 SAMPLES 
CHANNEL, RAW, 4 
RADIANCE, 0, 35 

TICK, SCAN, 2400 LINES, 3300 SAMPLES PRIMARY 

SCAN, 100 LINES, 100 SAMPLES SECONDARY 
ZONE, ** (UTM CENTRAL MERIDIAN****** DEG) 


KMD0N 

KMDSAT 

KMDINT 

KMDGRA 

KMDWIN 


KMDSPA 

KMDCHA 

KMDRAD 

KMDTIC 

KMDZON 


2.7.2.15 

2.7.2.13 

2.7.2.14 

2 . 7 , 2. 9 


2 . 1 . 2.1 
2 . 1 . 2.2 
2 . 7 . 2. 6 
2 . 7 . 2. 8 

2.7.2.10 


a. User commands for radiance data: 

>ORIGIN, SCAN ,1100 , 561 
>HEADING,1,RSIS FUNCTIONAL TEST 1 
>DIS1,RAC 

The macro command: 

>DIS1,RAD calls up the following default commands: 
>COLOR, DELETE 
>SATURATION, 62 , 31 
>INTENSITY ,0,0, 100 , 31 


KMDORI 2 . 7 . 2 . 5 

KMDHEA 2.10.2.2 


KMDCOL 2 . 7 . 2 . 3 

KMDSAT 2.7.2.15 


Table 1 “ h 
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RADIANCE DATA (Cont.) 

>COLOR,C01,0,C02,10, , ,COLOR,C03 , 20 ,C04 , 23 
>COLOR,C05,24,C06,26, , ,COLOR,C07 , 27 ,C08 , 30 
>C0L0R, C09 , 3 3 , CIO , 3 5 

MODULES 

EXERCISED 

>DISPLAY, RAD 

CLRDIS 

2.7.3 

b. User commands for gradient: 

CLRDI3 

2. 7. 3.1 

>DIS1,GRA 

CLRDIS 

2.7.3 

The macro .command DIS1,GRA calls up the following 
default commands: 

CLRDI4 

2. 7. 3. 2 

>C0L0R, DELETE 

KMDCOL 

2. 7. 2. 3 

>SATURAtlON,62,31 

KMDSAT 

2.7.2.15 

> INTENSITY ,0,0,100,31 

KMDINT 

2.7.2.13 

>COLOR,C01,0,C02,10 

>COLOR,C03,20,C04,23, , , COLOR, COS, 24, C06, 26 
>COLOR,C07,27,C08,30, , ,COLOR,C09 , 33 ,C10 , 35 

KMDCOL 

2. 7. 2. 3 

>DISPLAY,GRA 

CLRDIS 

2.7.3 


CLRDI4 

2. 7. 3. 2 


c. User commands for Laplacian: 

>DIS1,LAP 

The macro command DIS1,LAP calls for the following 
default commands : 


>COLOR, DELETE 

KMDCOL 

2. 7. 2. 3 

> SATURATION, 6 2, 31 

KMDSAT 

2.7.2.15 

> INTENSITY ,0,0, 100 , 31 

KMDINT 

2.7.2.13 

>COLOR,C01,0,C02,10 

KMDCOL 

2 . 7 . 2 . 3 

>COLOR, C03 , 20 , C04 , 2 3 

>COLOR,C05 , 24,006,26 , , , COLOR, C07 , 27 ,C08 , 30 

>COLOR,C09,33,C10,35 

>DISPLAY,LAP 

CLRDIS 

2.7.3 


CLRDI6 

2. 7. 3. 4 

User commands for class 

KMDORI 

2. 7. 2. 5 


> ORIGIN , SCAN, 1100 , 306 
>DIS1,CLA 

The macro command DIS1,CLA calls up the following 
default commands ; 


Table 1-c 


DEFAULT COMMANDS (Pont.) 


MODULES EXERCISED 


>COLOR, DELETE 
>RADIANCE,l,ia 
> SATURATION, 62, 31 
>INTENSITY, 100, 0,100,0 

>COLOR,GOl, 10,002,11, , , COLOR, 003 ,12 ,004 ,13 
>COLOR,C05,14,C06,15, , , COLOR, 007, 16, 008, 17 
>COLOR, 009 , 18 , CIO , 19 
>DISPLAY,CLA 


KMDCOL 2 . 7 . 2 . 3 

KMDRAD 2. 7. 2. 6 

KMDSA"’ 2.7.2.15 

KMDINT 2.7.2.13 

KMDCOL 2 . 7 . 2 . 3 


CLRDIS 2.7.3 

CLRDI5 2. 7. 3. 3 


2 . 


In order to exorcise some remaining modules , execute CLRTAB again using some 
macro commands from the DAM package. 

RSIS i,0 |-iMANDS MODULES EXERCISED 


Overall default commands as in first CLRTAB execution 

User commands: 

a. >ORIGIN, SCAN, 1100, 561 
. >COLOR, DELETE 

>COLOR,C01,0,C02,10, , ,COLOR,C03 , 20 ,C04 , 30 
>COLOR ,C05,40,C06,50 
>@ADD DAM.WATER-NESS/2B 


The WATER-NERS transform invokes the following commands: 
SHARPENING, 1, SAMPLE, .0000, .0000 

SHARPENING, 4, SAMPLE, .0000. .00000 


LINEAR, 

1, 

WEIGHTS , 

LINEAR, 

1, 

GAIN, 

LINEAR, 

1, 

BIAS, 

LINEAR, 

2, 

WEIGHTS 

LINEAR, 

2, 

GAIN, 

LINEAR, 

2, 

LIAS , 

CHANNEL, 

LINEAR, 

RADIANCE 

' t 

0, 36, 


- 1 . 0000 , . 0000 , 
1.000 
35,420 

. 0000 , . 0000 , 
1.000 
.000 
2 
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,.0000, 2.1600 

\ 


.0000, 1.0000 


- d 


KMDSHA 2.7.2.12 

KMDLIN 2 . 7 . 2 . 4 


SYMBOLS 


SYMBOLS, 

0.000, 

0.020 

SYMBOLS , 

1.021, 

9.029 

SYMBOLS , 

A. 030, 

T.049 

SYMBOLS , 

11.050, 

7.127 

(016) : 

• hie 


(017) : 

j ** 

SYMBOLS 

(018) : 

j * * 

0 

1 

(019) : 

. ** 

■8' - '9 

(020) : 

: ** 

■A' - 'G 

(021) : 

. hh 



MEANING (LANDSAT-2B) 
= WATER 
- MOSTLY WATER 
= PARTLY WATER 


User commands: 

>DISPLAY, RADIANCE 
>DISPLAY, RADIANCE 

>TABULATE 
>PACTOR 
> ROTATE 

In order to exercise the POLAR command invoke the 
macro command 

>MARSH-LIM-2B,44 

This macro command invokes the following commands : 

NAME, MARSH-LIM-2B,44 TESTl 
SHARPENING, 1, SAMPLE, .0000, .0000 

SHARPENING, 4, SAMPLE, .0000, .0000 

LINEAR, 2, WEIGHTS, .0000, .0000, .0000, 1.00000 

LINEAR, 2, GAIN, 1.000 

LINEAR, 2, BIAS, 1.000 

LINEAR, 1, WEIGHTS, 1.0000, .0000, .0000 

LINEAR, 1, GAIN, 1.000 

LINEAR, 1, BIAS, -5.260 

POLAR, 2 (ANGLE), GAIN, 57.296 

POLAR, 2 (ANGLE), BIAS, .000 

POLAR, 1 (RADIUS), GAIN, 1.000 

POLAR, 1 (RADIUS), BIAS, .000 

CHANNEL, POLAR, 2, 1 

RADIANCE, 0, 44, 0, 33 

Table 1 - e 


MODULES EXERCISED 


CLRDIS 

CLRDI3 

CALCOL 

DISTB 

CLRFAC 

PICROT 


KMDPOL 


2.7.3 
2. 7. 3.1 
2 . 7 . 3. 6 

2.7.4 

2.7.5 

2.7.6 


2 . 


User commands: 


>DISPLAY , RADIANCE 

>EXIT 

©FREE 2. 

@FREE 25. 


PARI’ B 

CRTCLASS and CRLCLASS 

To test the modules used in the output of a CRT color map, enter the following: 
@ASG,T 2., 16N, W9127R 
@USE DAMDET-1., DEN-1. 

@USE DAMDET-2 . , DEN-2 . 

@USE DAMDET-3., DEN- 3. 

0USE DAMDET-4., DEN-4. 

0ASG,A DAMDET-1. 

@ASG,A DAMDET-2. 

@ASG,A DAMDET-3. 

§ASG,A DAMDET-4. 


RSIS COMMANDS 

MODULES 

EXERCISED 


CRTCLASS 

2.13 


CRTXQT 

2.13.1 


CRTOOO 

2.13.2 


Default commands for density file: 
>DENSITY,10,18 

KMDDEN 

2.10.2.1 

>COUNT,l 

KMDCOU 


>SATURATION,18 

KMDSAT 


>SCALE, 1/24 000 

KMDSCA 

2.10.2.4 

>WINDOW, PRINT, 5 :G, 500 

KMDWIN 

2. 7. 2. 9 

>TICK,MIN,1,1, 

KMDTIC 

2. 7. 2. 8 

>ZONE,14 

KMDZON 

2.7.2.10 

>CRT,RES,511,511 

KMDCRT 

2.13.2.1 

>CRT,SCR,19 inches diagonal 
>GRAPHICS , DELETE 

KMDGRA 


>COLOR,C01,O,C^I2,5 

KMDCOL 

2. 7. 2. 3 


>COLOR,C03 , 10 ,C04 , 18 


Table 1-f 


User commands: 


>0RIGIN , SCAN , BOO ,1800 

KMDORI 

2. 7. 2. 5 

>HEA,1,RSIS FUNCTIONAL TEST 

KMDHEA 

2.10.2.2 

>MAP 

CRTMAP 

2. 1.3. 3 


CRTPRT 

2.13.3.1 


REGCRT 

2.13.3.1.1 


LINOUT 

2.13.3.1.2 


SENDRE 


>TABULATE 

CRTTAB 

2.7.4 

>EXIT 

CRTEXI 

2.13.6 


Do you want detection files saved: 


>NO 



@C0PY 

RAD-1. , 

DAMDET-1. 

0COPY 

RAD-2. , 

DAMDET-2. 

0CO:'Y 

RAD-3. , 

DAMDET-3. 

0COPY 

RAD-4 . , 

DAt4DET-4. 

>0XQT 

CRTCLASS 


RSIS COMMANDS 

MODULES 

EXERCISED 


CRTCLASS 

2.13 


CRTXQT 

2.13.1 


CRTOOO 

2.13.2 


Default commands for radiance file: 
>RADIANCE,0,61 

KMDRAD 

2. 7. 2. 6 

>C0UNT,0 

KMDCOU 


>SATURATION,61 

KMDSAT 


>SCALE, 1/24000 

KMDSCA 

2.10.2.4 

>WINDOW , PRINT , 500 , 500 

KMDWIN 

2. 7. 2. 9 

>TICK,MIN,1,1 

KMDTIC 

2. 7. 2. 8 

>ZONE,14 

KMDZON 

2.7.2.10 

>CRT,RES,511,511 

KMDCRT 

2.13.2.1 

>CRT,SCR,19 inches diagonal 
>GRAPHICS, DELETE 

KMDGRA 

2.7.2.14 

>COLOR, CjZll , 0 , C02 , 10 

KMDCOL 

2. 7. 2. 3 


>COLOR, Cp3 , 20 , CJ2I4 , 50 
>C0L0R, C05 , 55 , C06 , 61 


Table 1-g 


User commands for radiance fXle; 
>ORIGIN , SCAN , 800 , 1800 
>HEA,l,r<SlS FUNCTIONAL TEST 
>MAP 


>TABULATE 

>EXIT 

Do you want detection files saved? 
>YES 

@ASG,T 25., 1^40///500 
0COPY CLASS-1., 25. 
tlASG,T 26. , F-10///500 
0COPY CIASS-2., 26. 

(.‘1ASG,T 27., F.10//750Q 
(pCOPy CIASS- 1. , 27. 

0ASC,T 28., F.10///500 
ycOPY CLASS-1, , 28. 

0XQT CRLCIiASS 


RSIS COMMANDS 

Default eoimnands for class file: 
>R?vDIANCE,0,6J 
> COUNT, 0 
SATURATION, el 
'•SCALE, i/:mooo 

> WINIXW, P RINT , 500 , 500 
'• TICK, MIN , 1 , 1 

> ZONE, 14 

> CRT, RES, 511, 511 
5 GRAPHICS , DELETE 
>COLOR,C07,O,C02,5 

> COLOR, G)33 , 10 , Cf!»4 , 15 
i- GOLOR,C05,2O,C(36,61 


KMDORI 

2. 7. 2. 5 

KMDHEA 

2.10.2.2 

CRTMAP 

2. 1.3. 3 

CRTPRT 

2.13.3.1 

REGCRT 

2.13.3.1.1 

LINOUT 

2.13.3.1.2 

SENDEE 


CRTTAB 

2.7.4 

CRTEXI 

2.13.6 


CRLCIiASS monitor 

CRLXQT - initiate CRLCLASS 

CRLOOO - get user commands 

MODULES EXERCISED 


KMDRAD 

2. 7. 2. 6 

KMDCOU 


KMDSAT 


KMDSCA 

2.10.2.4 

KMDWIN 

2. 7. 2. 9 

KMDTIC 

2. 7.2.8 

KMD20N 

2,7.2.10 

KMDCRT 

2.13.2.1 

KMDGRA 


KMDCOL 

2. 7. 2. 3 


/3 


Table 1-h 
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Usoi' coHunaniis : 


'' 0 KI 15 IN, SCAN , dUO , IBOO 

KMDORX 

2 . 7 . 2 . ii 1 

''UKADINd,l,Rind FUNCTIONAl, Tl'.HT 

KMDUEA 

2 . 10 . 2.2 1 

''MAD 

Cl^MAD 

i 


CRLPRT 

; 


REGCKL 

i 


blNOUT 



SBNDRE 


''TABUbATK 

CRKTAB 

2 . 7.4 

''EXIT 

CRI^EXI 



Da you want dotoot ion filon navod? 
>N 0 


i 


Table 
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If 
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TABLE 2 


UNIVAC SOFTWARE WORKING ENVIRONMENT TEST 
PART A - CLRTAR 


RADIANCE DISPLAVS 

Initiate program CLRTAB by procedures similar to those in Table 1. 

Use a variation of the following user commands* for the working environment test 
for radiance displays. 

SATURATION 

INTENSITY , 1 

COLOR, 

WINDOW, 

ORIGIN, 

TICKS 

SPACING , 

HEADING , . . . . 

GRAPHICS 

CHANNEL, 

RADIANCE, 

ZONE 

POLAR, 

LINEAR, 

FACTOR, 

ROTATE 

DISPLAY, IU\1)IANCE 
TABULATE , RADIANCE 

V 

*A description of these commands and their variations are in Appendix J 
in tlie RSIS User's Guide. 

GRADIENT DISPLAYS 

Use the same commands or variations as for radiance displays except use: 

DISPLAY , GRADIENT 
TABULATE , GRADIENT 



Table 2-a 


LAPLACIAN DISPLAY S 

Use the same commands or variations ns for radiance displays except use 

DISPLAY , LAPLACIAN 
TABULATE , I.APLACIAN 

CLASS DISPLAYS 

Use the same conunnnds or variations as for the radiance displays except use 

DISPLAY, CIJVSS 
TABULATE, CIJ\SS 


UNIVAC SOFTWARE WORKING ENVIRONMENT TEST 


PART B - CRTCLASS 


I^DIANCE DATA 

Initiate program CRTCLASS by procedures similar to those in Table 1. Have present at 
least one RADIANCE detection file. 

Use and variation of the following couunands is suggested for the working environ- 
ment test: 

COLOR, 

COUNT, 

SCALE, 

WINDOW 

ORIGIN, 

TICKS 

HEADING , 1 , 

RADIANCE, 

TABULATE 

Use of the GRAPHICS command is also suggested, specifying the names of default color 
and image files resident on the INTERDATA. 

The following commands may also be varied, but normally are used only as default 
conuTiands : 

SATURATION, 

GRAPHICS 


CRT 


/ • • • • 


Table 2-b 


DENSITY DATA 


Initiate program CRTCLASS by procedures similar to those in Table 1. Have present at 
least one DENSITY detection file. 

Use and variation of the following commands is suggested for the working 
environment test; 

COLOR, 

COUNT, 

SCALE, 

WINDOW, 

ORIGIN, 

TICKS 

HEADING , 1 

RADIANCE, .... 

TABULATE 

CLASS DATA 

Initiate program CRLCLASS by procedures similar to those in Table 1. Have 
present at least one ELLTAB class file and one detection file of any type for 
the same scene. 


Use and variation of the following commands is suggested for the working environment 
test. 

COLOR, 

COUNT, 

SCALE , . . . . 

WINDOW, 

ORIGIN, 

TICKS 

HEADING, 1, 

RADIANCE 

TABULATE 


Use of the GRAPHICS conuiiand is also suggested, specifying the names of default color 
and image files resident on the INTERDATA. 


n 


Table 2-c 


The following commands may also bo varied, but normally are used only as default 
commands ; 


SATURATION, 

GRAPHICS 

CRT , . . . . 


Table 2-d 


PART II 

RSIS ACCEPTANCE TEST PROCEDURES 
INTERDATA/RAMTEK DISPLAY PROCESSOR 

1. PURPOSE AND SCOPE 

The Interim Interactive Graphics Subsystem (IIGS) is an integral 
part of the RSIS and its general purpose is to allow a user to 
visually analyze image data on a color cathode ray tube (CRT) . 

The software developed for the IIGS allows the user to perform 
analysis in an interactive mode on the INTERDATA 7/32 computer 
using the RAMTEK 9351 processor for the image display. The anal- 
ysis performed by the user utilizing the IIGS is limited as 
all calculations done on the raw image pixel data will be done 
in the pre-processing software of the RSIS version of the DAM 
package. 


2 . OVERVIEW 

The IIGS software performs the following task; 

• Display of an image window (512 pixels by 512 lines maximum) 

• Report of CRT coordinates of the cursor positioned at a point 
of interest 

• Color Table Report containing colors being used in current 
image 

• Color changes of colors in the existing color table 

• Interactive user menu/query capabilities to provide user 
control of the software functions. 


n 


1 


PART II 

RSIS ACCEPTANCE TEST PROCEDURES 
INTERDATA/RAMTEK DISPLAY PROCESSOR 


1. PURPOSE AND SCOPE 

The Interim Interactive Graphics Subsystem (IIGS) is an integral 
part of the RSIS and its general purpose is to allow a user to 
visually analyze image data on a color cathode ray tube (CRT) . 

The software developed for the IIGS allows the user to perform 
analysis in an interactive mode on the INTERDATA 7/32 computer 
using the RAMTEK 9351 processor for the image display. The anal- 
ysis performed by the user utilizing the IIGS is limited as 
all calculations done on the raw image pixel data will be done 
in the pre-processing software of the RSIS version of the DAM 
package. 


2 . OVERVIEW 

The IIGS software performs the following task: 

• Display of an image window (512 pixels by 512 lines maximum) 

• Report of CRT coordinates of the cursor positioned at a point 
of interest 

• Color Table Report containing colors being used in current 
image 

• Color changes of colors in the existing color table 

• Interactive user menu/query capabilities to provide user 
control of the software functions. 
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The IIGS doer, not interactively interface with any other applica- 
tions system. However, its use is dependent upon pre-processing 
of raw Land sat data or other forms of raw image data by the RSIS 
version of the DAM package. The IIGS utilizes software modules 
from the RAMTEK Fortran Image and Plot Package (FIPP) , the INTER- 
DATA Run Time Library and the RAMTEK supplied RAMTEK/INTERDATA 
software interface drivers. 

The IIGS will also accept as a form of input data a computer 
compatible tape (CCT) that was output by the IIGS in a RAMTEK/i 
INTERDATA compatible format in a previous execution of the IIGS. 

The IIGS software operates in the interactive mode on the INTER- 
DATA 7/32 under the control of the INTERDATA OS/32 operating 
system. Figure 1 presents the general operational data flow 
for the IIGS. 
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3. OPERATING PROCEDURES 


All image data input to the IIGS will either be contained on a 
CCT output by the RSIS version of the NASA DAM Package Software 
or will be contained on an INTERDATA/RAMTEK compatible CCT 
created during a previous IIGS execution. Both types of input 
CCTs are reicorc'ed on a nine-track 1600 bits per inch (bpi) digital. 
CCT. The formext of the RSIS CCT output by the RSIS version of 
DAM is detaj.led in Appendix A of this document. The INTERDATA/ 
RAMTEK compatible CCT format is detailed in Appendix B of the 
User's Guide. 

In the nox'uial operations of the IIGS, the user will have control 
of the IIGS to perform all operations supplied by the IIGS software. 
The user controls the IIGS software by entry of an appropriate 
response to queries or menus output by the IIGS. The queries and 
menus output by the IIGS are detailed in section 3.2 of this 
document. This section also contains infomation describing the 
results of any user response. 

3 • 1 PRE-OPERATING PROCEDURE 

In order to execute the IIGS software on the INTERDATA 7/32 
computer, the IIGS software must be compiled, a load module 
built and the load module linked with the INTERDATA 7/32 Run 
Time Library routines, the RAMTEK FIPP object modules and the 
RAMTEK/INTERDATA software. Appendix D of the User's Guide details 
the files that build the load modules, link the modules and the 
job file to execute the IIGS software. 

The user must perform the following steps in order to begin the 
IIGS processing; 


1. Mount the input CCT on the INTERDATA 7/32 tape drive and 
ready the tape drive. 


2 . 


Turn the RAMTEK processor power on. 

3. Depress the reset switch on the RAMTEK. 

4. Turn the RAMTEK CRT on. 

5. Make sure the INTERDATA 7/32 is running and is ready to 
execute the IIGS software. 

6. Load the IIGS executable file into the INTERDATA 7/32. 

3.2 PROCEDURES FOR OPERATING THE IIGS 

The IIGS menus , queries , and user responses are detailed in the 
following paragraphs. This test procedure deals with the queries 
and responses that are required to operate the IIGS when the 
input is on a RSIS CCT generated by the RSIS version of 
the NASA DAM software package. This form of input is referred 
to as the standard input. 

All diagnostics (error messages, warning messages, and user 
diagnostic options) are detailed in Appendix C of the IIGS 
User's Guide. 

3.2.1 RSIS CCT PROCESSING 

In the following paragraphs each query is numbered for documenta~ 
tion purposes. In actual operation of the IIGS the query numbers 
do not appear. 

Query 1 - Begin Processing 

The IIGS begins processing image data by outputting* the 
following: 

RSIS INTERIM INTERACTIVE GRAPHICS SUBSYSTEM 

*A11 input and output described in this section of the document 
refers to input from and output to the IIGS alpha-numeric terminal 
or operator's console. 
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IK]’UT DATA IN RSIS UNIVAC FORMAT (Y or N) ? 


The IIGS outputs Query 1 in order to determine the proper IIGS 
processing branch to take. This subsection deals with the 
standard fox"m of input, an RSIS INIVAC written CCT. Therefore, 
the user will input either a "Y" or a "YES" response to the 
above query. 

Query 2 - Determination of Input Medium 

Following the user response to Query 1, the IIGS will output: 
INITIALIZE THE IIGS FOR RSIS CCT PROCESSING 
IS THE STANDARD INPUT ON A DISC FILE (Y or N)? 

The standard input will normally be on a CCT. Therefore, the 
normal response to Query 2 is a user input of an "N" or "NO." 
However, if the input image data is stored in a disc file on the 
Interdata 7/32, then the user will enter a "Y" or "YES" following 
Query 2. If a "Y" or "YES"* response is input, then IIGS will 
output; 

FILE NAME = 

The user will then input the name of the file on the INTERDATA 
7/32 disc that contains the image data to be processed. 

Query 3 - Obt aining Imago. Data File Number 

Followi.ng the user interaction with Query 2, the IIGS will output; 

ENTER THE FILE NUMBER ON THE RSIS CCT TO BE PROCESSED. 
FILE NUMBER = 

*In the following paragraphs when an input of a "Y" is noted a 
"Y'ES" can also be input to obtain the same result. Similarly, 

^ when "N" can be input a "NO" can also be input for the same result 
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The user will then input the file number on the RSIS CCT which 
contains the image data to bo processed during the current pass 
(execution) in the IIGS. The input RSIS CCT can contain multiple 
im^ge data files and the above query provides the user the capability 
to select any file on the input RSIS CCT for processing. The 
above entry is expected to be input in a Fortran "12" format. 

This means if the user inputs a single integer value, then this 
single intnger must be preceded by a zero or a blank character, 
e.g., the user wants to process data in the fourth file, therefore 
the user responds to Query 3 with an input of either "04" or ")^4" 
symbolizing the blank character). 

The IIGS will then begin to search for the selected file on the 
input RSIS CCT. 

Query 4 - User Selection of Mode of RAMTEK Initialization 

Upon finding the selected image data file, the first record (the 
UNIVAC header record) will be read into core storage. If the 
read is successful, the following will be output: 

DORS THE USER WANT TO INPUT THE TYPE OF INITIALIZATION 
(Y or N)? * ^ 

If the user does not v?ant to select the type of initialization, 
then an "N" is input following the above query. The type of 
initialization for the RAMTEK common blocks stored in word 4 of 
the UNIVAC header record will be used and the following queries. 

Query 3 and the queries described in Tables 1 and 2, v;ill be 
skipped. 

If the user v/ants to choose the type of initialization to be 
performed for the RAMTEK common blocks in the IIGS, then the 
user will input a "Y" following Query 4. 




Query 5 - User Selection o£ Typo o f Initialiy.ation 

I 

If the user inputs a "Y" following Query 4, then IIGS will output 
the following quory/menu - ' 

KHAT TYPE OF INITIALIZATION IF REQUI’^ED? 

0 = TEIIMINATE THE CURRENT EXECUTION 

1 = TERMINAL INPUT 

2 = STANDARD INITIALIZATION 

3 = NON-STANDARD INITIALIZATION 

4 = USER TYPE OF INITIALIZATION IN RSIS HEADER 

ENTER TYPE - 

The user will then input the integer number which represents the 
option that the user wants to exercise. In all easels, excapt 
response equal to 0 or 4, the type of initialization in the UNIVAC 
header record, record 1 in the current image file, will be ignored. 
The following paragraphs explain the above options; 

Initiali z atio n Option 0 - Terminate the Current Execution 

If the user inouts a "0" (zero) following the "ENTER TYPE-" 
query, then tJ)o follov.ing will be output; 

TERMINATION OF CURRENT EXECUTION REQUESTED BY THE USER. 

The IIGS will then end the current pass (execution) and begin 
another pa.ss r^tarting again with Query 1. The output of Query 1 
signifies that the IIGS software has been restarted. 

Initializat I jd n Option 1 - Terminal Input 

If the user input a "1" (one) following the "ENTER TYPE-" 
query, then the IIGS will 'expect the user to manually enter all 
RAMTEK common iDlock variable initialization values via the alpha- 
numeric terminal. The manual inputs will be detailed in Tables 
1 and 2. 


Initictlizat io n Option 2 - St andard I nitialiy.a t.lon 
If the user inputs a ''2" (two) follov;ing the "ENTER TYPE-" query, 
then the IIGB will sot all RAMTEK coiranon block initialization vari- 
ables to standard settings hard coded into the IIGS software. The 
hard coded initialization values are detailed in Table 3. 

Initializatio n Option 3 - Non-Standard Initial i z a t ion 

If the user inputs a "3" (throe) following ie "ENTER TYPE-" query, 
then tlie IIGS will initialize all RAMTEK common block vari- 
ables that are to be initialized for RAMTEK Level 3 and Level 4 
modules with values stored words 5 through 82 in the UNIVAC header 
record, record one of the image file. See Appendix A Record 1 
- UNIVAC to RTVMTEK HEADER RECORD for details of words 5 through 82. 

Initialization Option 4 - Use Type of I nitialization in RSIS Header 
If the user inputs a "4" (four) following the "ENTER TYPE-" query, 
then the IIGS will use the type of initialization option stored in 
word 4 of the UNIVAC header record. In essence this is the same 
as if the user had entered a response o.f "N" following Query 4. 

Illegal Option 

If the user inputs a value less than zero or greater than four, 
then the IIGS will output the initialization menu/query again. 

Initialization Message Output Following Query 4 or Query 5 
Following the user selection of initialization type or using the 
type of initialization cede stored in the UNIVAC header record, 

IIGS will output: 

RAMTEK LEVEL 3 and 4 INITIALIZATION 

If tlie type of initialization is type 1, the initialization of the 
RAMTEK Level 3 and Level 4 common block variables will be done 
manually, via input from the alpha-numeric terminal, by tlie user. 
The IIGS, in this case, will output: 

INITIALIZATION INPUT FROM THE USER VIA TEimiNAL 
REQUESTED, USER MUST MAKE AN ENTRY FOR EACH REQUESTED 
ENTRY. BEGIN LEVEL 3 INITIALIZATION 
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Tho i nl t. i .i!( L.j.oa menu J.ca Lavol .5 initioi.i.'/ation wi.l .1 then be 
output. TIk'. entries in this menu arc detailed in Table 1. Aftor 
thc u.'ic.r liau jiindc ctLl the rc'quired Level 3 entries, the XIGS wili 
output : 

BEGiti LLVlhj 4 IKlTJ/iLIZATION 


The init'i ali.nation menu for Level 4 in ltiali?:ation v;ill then be 
output. The entj ies in tin i-i menu are detailed in Table 2. 


Table: 1 - KAr''^T:K LLVLL 3 Cv.)!!', '.0]'J Ih .OCK NON -STA ND ARD IN l'J'IALIZATl'OH 
rVi-lNU 


Tlic lies will, output the ioJ ],ov;ing query prior to outputting 
the Level 3 :i.nit.ialii:’c't.i on menu. 

STANl.u\UD LKVLL 3 .l,I«.TTALIZ7t,L'I0N (Y OR N) ? 


If tlv: user inputs a "Y" o.r a "YES", then the IIGS will use the 
standard initialization values detailed in Table 3 for level 3 
init in li xation and the follov/ing mouu will not be outpjut. 


T.t the unor inputs on "N" or a "NO" :cesponse, then the follov;ing 
menu v.’i 1 1 b'.: output. If; au .integer value is to be input for 
any of tine foil ov, ring entric'S, then tlio entry must be compatible 
v'ith .1 PtutTitAK "II 0" format. That is to say if et usoi." v.'ants to 
■input a nimjU: integer Vviluc, tlion he must ojitc.r nine preceding 
/.crors or nine pre.ocdincj biankr. , etc., o.g,, if a user wants to 
I'uitcn a value of 2048, then he musi; input either "0000002048" or 

»* o i» 
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RAMT.b;.i: LEVEL 3 lElTlALIZAT.TON MENU 


Iv. EOC.ncAi, unit - user iiii>nts the reguirod .logical unit number, 

No:,T.i.n.l ly a. 6 will be input. 

!':'.i,.X.LES,‘-;.l NO .LOOIChL UNIT = Ui;ea' inputs the required logical 

unit numl.-)er. Normally a 7 will be 
ininil:. 
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EVf'JNT FLAG C>10 UfiC'r j.n])utr, I ha racju i rad event flag nuJiibcr. 

Norma 'l.‘ly a .1 will bo .input. 

X RljEOLUTION •• Uyor w;i 1 X input' tlii- horir.on taJ. resolution of the 

RAMTEK Cl Vi'. Norma Jly 512 will bo input, 

X RESOLUTXOKi 'Jser will input the vertical resolution of the 

RAMTEK C.NT. Normally 512 v;ill be input. 

NO. OF MEi'iOlvV PLANES ~ U.ner input tlio number of memoiry plane.s 

cxistincj in the RAMTEK 9351 processor. In 
tlio 'J'o>:a.s KSTS RAMTEK. 12 will alv;ays be input. 

VLT V.’lDTli ;iN lUTS == U.soi: will input a 13 as there are 13 bit.s in 

each Video Looltup Table (VLT) storage location. 

VLT LENGTH IN WORD.S ~ U.ser will input the? value 2048 as there are 

204 8 storago local :ion.s in the VLT. 

BLINK (y or N)V If the u.sor wants 'the video to blink, a "Y" or "YES" 
will be inj'Ut. Otho.rwi.se input an "N" or a "NO". 

FIHMNAHE OPIMONS N) 

TNTERACTIVP Pf.NTlHlEPALS? User should enter a "Y" or "YES" as tliere 

are qrajililcs interactive pe.ripherals in 
the Texas RSIS RAMTEK. 

GRAldllCS? User sliould cn1er a "Y" or "YES" as there are graphic 
capalvillticu in the Tcv'-'.as RSIS RAMTEK. 

SCROLL! Usoj' should onl.or an "N" or "NO" cis the RAMTEK series 
9 3 Xa lias no .scrolling capability. 

STATUS MANAGiP-iJiNT? User should enter an "N" or "NO" as this 

capiH-iJ .1 ity i.s not sui.-ported on the Te.xas RSIS 

RAMTEK . 

PKOGRANMMiLr.'l'ONT? User .should enter an "N" or "NO" as tlie Ramtek 

ProgrammabJe Font supiport firmware doc.s not 
exist on the 'J'oxas RSIS RAMTEK. 


TABLE 1 - Concluded 

USER SUBROUTINE? User should enter an 'N" as a "user subroutine” 

does not replace any of the existing RAMTEK 
FIPP modules . 

RT-11 MODE (y OR N) ? User should enter an "N” or "NO" as the 

Texas RSIS host processor is an INTERDATA 
7/32 not a DEC processor with the RT-11 
Operating System. 

TRACE FLAG ON (Y OR N) ? Normally the user will enter an "N" 

or "NO". However, if an error occurs 
the user might want to enter a "Y" 
or "YES" to force a walk back through 
RAMTEK modular associated with the error 

DEBUG FLAGS ON (Y OR N) ? Normally the user will enter an "N" 

or "NO". However, if an error is 
encountered the user could input a 
"Y" or "YES" to force some debug in- 
formation to be output by the RAMTEK 
FIPP modules . 
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TABLE 2 - 1V\MTEK LEVEL 4 COMMON BLOCK NON-STANDARD INITIALIZATON 
MliNU 

The IIGS wil] output the following query prior to outputting the 
level 4 initia! ization menu. 

STANDARD LEVEL 4 INITIALIZATION (Y OR N) ? 

If the user inputs a "Y" or a "YES", then the IIGS will use the 
standard initialization values detailed in Table 3 for level 4 
initialization and the following menu will not be output. 

If the user inputs an "N" or a "NO" response then the following 
menu will be output. If an integer value is to be input for 
any of the following entries, then the entry must be compatible 
with the FORTRAN I/O "110" format. That is, if a user wants to 
input a two integer value, say 10, then the user must input eight 
preceding zeros or eight preceding blanks, e.g., if the user 
wants to enter a value of ten, 10, then the user must input 
either "0000000010" or "10". 

RAMTEK LEVEL 4 INITIALIZATION MENU 

IMAGE LOGICAL UNIT = The user enters the required logical unit 

number. Normally the user will input a 
4 (four) . 

REVERSE PACKING FOR WT & WR (Y OR N) ? 

The user will normally enter an "N" or "NO" 
as the data used with the Write Text (WT) 
or Write Roster (WR) will not be packed in 
reverse order. 

CT BIAS -• The user will input the bias to add to the VLT index 
to obtain external or displayed CT values to colors. 
Normally, the user will enter a' zero (0) . 

CT SCALE FACTOR = The user will input a scale factor to multiply 

the VLT index by to obtain external or displayed 
CT values to colors. Normally the user will ente 
a one (1) . 
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VLT DEVICE NUMBER = The usei: v/ill input the video lookup table 

(VLT) device number. Normally the user will 
input a zero (0) . 

NUMBER OF RESERVED VLT ENTRIES - The user will enter the required 

value. In normal processing, 2 entries are 
reserved. Therefore, normally the user will 
input a value of two (2) . 

CURSOR DEVICE NUMBER - The user will input the cursor device number 

for the Texas RSIS system; this value will be 
zero (0) . 

KEYBOARD DEVICE NUMBER - The Texas RSIS RAMTEK does not have a 

RAMTEK keyboard device. However, for software 
compatibility the user will input a zero (0) . 

ENTER NAMJi: OF TEMPORARY IMAGE WORK FILE - The user will input the 

name of the file that will be used by various 
RAMTEK FIPP modules for temporary .storage. 

The normal input is " 0532 :WRKFIL.WRK. " 


CURSOR WAIT TIME IN CLOCK TICS - The user will input in clock 

tics (tic = 1/60 sec) the time delay to be 


used in v;aiting between cursor polling. 
Normally the user will enter a 30 (thirty). 

NUMBER OF OVERLAY CHANNELS - The user v/ill enter the number of 

channels (memory planes) that are to be used 
in the overlay mode. Normally a 2 (two) will 
be input. 

If a number >0 is entered for the number of overlay channels, 

then the followi.ng will be output: 

CHANNEL 1 BIT NUMBER = The user inputs the bit number (0-11) 

associ-ated v/ith overlay channel 1. Normally, 
. if used, an 11 (eleven) will be input. 

CHANNEL 4 BIT NUMBER = 
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If the type of: initialization is type 2, then initialization of 
the RAMTEK Level 3 and Level 4 conimon block variables will be done 
using values for the conunon block variables that have been hard 
coded into the IIGS software. Table 3 contains the variables 
and the hard coded standard settings for these variables when 
standard initialization is done. IIGS will output: 

STANDArd) RAMTEK LEVEL 3 AND 4 INITIALIZATION SELECTED. 

If the type initialization is type 3, then initialization of the 
RAMTEK Level 3 and Level 4 coimnon block variables will be done 
using the values stored in words 5 through 83 of the UNIVAC 
header record. See Appendix A record for details. When 
initializcition type 3 begins, IIGS will output: 

NON-STANDARD RAMTEK LEVEL 3 INITIALIZATION SELECTED. 

QUERy 6 - COLOR INITIALIZATION WITH STANDARD COLOR FILE 

If the information in the UNIVAC header record indicates that a 
standard color file is to be used with the current image display, 
then the IIGS will output: 

A COLOR FILE IS TO BE USED IN THE CURRENT DISPLAY. THE NAME 
OF THE INTERDATA COLOR FILE IS: CFILE NAME : > IS THIS THE 

CORRECT NAME (Y or N) ? 

The user will then verify the file ncime as read from the UNIVAC 
header record. If the name is correct, then the user will input 
a "Y." 

If the name is incorrect or the user wants to use another file, 
then the user will input an "N." IIGS will then output: 

USER WANTS TO CHANGE COLOR FILE NAME. 

ENTER NEW NAT-IE - 


TABLE 3 RAMTEK 3,EVEL 3 AND I 4 EVFJ, 4 COMMON BLOCK VARTAPJ.F.S 


STANDARD SliTTINGS 


RAMTEK LEVEL 3 COMMON BLOCK VARIABLES INITIAL SETTINGS 


Variiiblc 

Name 

Coimncjn 

Block 

Description 

Initial 

Value 

XRES 

DEVCIIR 

X, Horizontal, resolution of the RAilTEK CRT. 

511 



less one 


YRES 

DEVOUR 

Y, vertical, resolution of the RAMTEK CRT less 

511 

■ 


one 


NPLANE 

DEVOUR 

Number of memory planes available to hold an 

12 



image value 


MAXMSK 

DEVCHR 

Maximvun nuniber that can fit in NPLANE bits 




plus 1 


XYMAX 

DEVOUR 

Greater of the two resolutions XRES or YRES 

511 

FRMOPT 

DEVOUR 

Array of flags identifying the firmware 




available in the display device. 




FRMOPT (1) = Interactive Peripherals 

True 



FRMOPT (2) = Graphics 

True 



FRMOPT (3) Scroll 

False 



FiyiOPT(4) = Status management 

False 



FRMOPT (5) = Prograiranable font 

False 



FRMOPT ( 6 ) = User subroutine 

False 



FRMOPT (7) = Conics 

False 



FRM0PT(8), . . .PRMOPT(IO) = SPARE 

False 

RMLUN 

INTEm'^ 

Logical unit number of the RAMTEK display 

6 



device 


ERRLUN 

INTERIM 

Logical unit number of the error report 

7 

■ 


disc file. 


EVNFLG 

INTERN 

Event flag used for operating system to 

1 



inform Iicvel 3 modules that I/O has completed 


lOSB 

INTEFiN 

I/O status block. The low byte of tlie first 




I/O statiu; block (ISOD(l)) entry contains a 




code indicating tlic; status of the I/O. A 




zero value indicates tlie I/O is ponding. A 




1 indicates sucessful I/O completion. A 




value indicates an error 




lOSB(l) 

1 



IOSB(2) 

0 
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TABIiE 3 

RAMTEK LEVEL 3 COMMON BLOCK VARIABLES INITIAL SETTINGS 


Variable 

Name 

Common 

Blook 

Description 

Initial 

Value 

IDS 

INTERN 

Directive status word. Indicates whether the 

1 



I/O was accepted and queued by the operations 




system. 




IDS = 0; I/O request pending 




IDS = 1; I/O request accepted 




IDS = -1; I/O request rejected 


OPTPLG 

OPTS 

Flag lior whether there are any options or 

Falpe 



parameters that need to be sent with the 




nc!.xt Ramtek instruction word. 




OPT(l) = Address mode option 

False 



OPT (2) - Additive write option 

False 



OPT (3) = Reverse, background option 

False 



OPT (4) = Reverse packing option 

False 



OPT (5) = Operand (parameter) option 

False 



OPT (6) = Data option 

False 

SUBMKS 

PARAMS 

Subchannel mask parameter 

4095 

FGDCOL 



Foreground parameter value 

4095 

BGDCOL 



Background parameter value 

0 

IXIX 



Index register 1 parameter X 

0 

IXIY 



Index register 1 parameter Y 

0 

IX2X 



Index register 2 parameter X 

0 

IX2Y 



Index register 2 i^arameter Y 

0 

ORGX 



0.rigin parameter X value 

C 

ORGY j 



Origin parameter Y value 

0 

WINGX 1 



Window parameter start X value 

0 

WINSY 



Window parameter start Y value 


WINEX 



Window parameter stop X value 

511 

WINEY 



Window parameter stop, Y value 

511 

SCAN 



Scan mode pai'ameter value 

0 

DIMW 



Dimension parameter width value 

7 

DIMH 



Dimension parameter lieight value 

9 i 

SPACER 



Horizontal space parameter value 

7 

SPACEV 



Veritcal space parameter value 

9 

FUNC 1 



Logical/arithmetic function parameter value 

0 

SCALE 



Scale parameter value 

0 

BASEL 



Baseline parameter value 

0 

SCRCNT 



Scroll Ck)unt parameter value 

0 

COPX 



Current Operating Point X Value 

0 

COPY 


\f 

Current Operating Point Y value 

0 

PARM 

P/iRMS 

A flag array of 16 entries with each entry 




corresponding to 1 of the 16 possible paramete] 

:s. 



(PARAM(l), ..., PARAM(16) = 

False 
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I^MTEK level 3 COr.lMON BLOCK VP.RIABLES INITIAL SETTINGS 


Variable 

Name 

Common 

Block 

Description 

Initial 

Value 

RTll 

TEST 

Flag for whether the package is running in the 
RT-11 mode or the RSX-llM mode. As the Texas 
RSIS is utili^.ing an INTERDATA 7/32 computer 
as the host processor and not a DEC machine, 
then this flag will always be set FALSE. 

False 

TRACE 

TICST 

Flag for w'hethcr RAMTEK module "ERROR" is to 
intentionally perform a divide by zero in 
order to produce a traceback by subroutine and 
line number wlicn an error is detected. 

False 

RWRK 

TEST 

Flag for v;hether module "BUILD" is to dump its 
built-up normal format instruction stream 

False 

BOPT 

TEST 

Flag for whether RAMTEK module "BUILD" is to 
dump the array "OPT" and v;hether the Ramtek 
module "INST" is to dump the operation code. 


INLUIl 

TEST 

Console or analyst alpha- number ic terminal 
logical unit number (input) 

5 

OUTLUN 

TEST 

Console or analyst alpha-numeric terminal 
output logical unit number 

7 

DBGLUN 

TEST 

Debug output logical unit number 

b 

VLTW 

VLTDAT 

Video Lookup Table width in bits 

13 

VLTL 

VLTDAT 

Video Lookup Table size (number of entries 
that can be stored in the VLT) . 

• 

48 

BLNR13 

VLTDAT 

Flag for setting blink bit in the VLT 

False 
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TABLE 3 (Continued) 


RAMTEK LEVEL 4 COMMON BLOCK VARIABLES INITIAL SETTINGS 


Variable 

Name 

Conuiion 

Block 

Defscription 

Initial 

Value 

IMBLUN 

L4COM 

Logical unit on which to rocid and write images 

4 

REVIVAL 

L4COM 

Flag for automatically setting reverse packing 
option when v;riting text strings 

False 

BIASS 

L4COM 

Bias to add to the VLT index to obtain 
external or dispalyed CT values 
CT = SCALEF*VLT index + BIASS 

0 

SCALEF 

L4COM 

Scale factor to multiply VLT index by to 
obtain the external or displayed CT values 

1 

PICUP 

L4COM 

Flag for whether an image has been displayed 

successfully on the RAMTEK CRT 

• 

False 

CURNO 

L4COM 

Cursor device number 

0 

KBNO 

WRKFIL 

L4COM 

L4COM 

Keyboard device nun±>er 

An array of 10 entries (?.0 characters) 
identifying the name to bo used for a 
temx^orary work file. 

Initial set to; OS32 : Wiy<FlL. WRK 

0 

CURSWT 

L4COM 

Time delay in clock tics (1 tic = 1/60 sec) 
to wait between cursor polling. Cursor 
movement docs not generate intempts in the 
RAMTEK FIPP package. Cursor movement is 
detected by repeatedly polling the cursor. 

30 

LWRKNM 

L4COM 

Num}3er of characters in array ’'WiyiFI'L** 

15 

NUMOUR 

OVRBIT 

OVfUAY 

OVRI.AY 

Number of overlay channels 

.Array of up to 4 entries containing the bit 
numJjer associated with each overlay channel. 
- OVRBITU) 

OVRBIT (2) 

OVERBIT (3) = OVRBIT (4) 

2 

11 

10 

0 

OVRPl/; 

OVRLAY 

Flag for whether the RAMTEK overlay mode has 
been selected 

False 
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Tabic 3(contimuHl) 


lyU.lTEK LEVEL 4 COMMON J3J.OCK VARIABLES INITIAL SETTINGS 


Variable 

Name 

Coimiion 

Block 

Description 

Initial 

Value 

OLDMSK 

0V1UJ\Y 

Mask parameter at time tlie overlay mode vas 
selected. This mask parameter will be restor 
when the overlay mode is terminated. 

0 

ed 

NAMDIR 

STDCOL 

Name of the color directory file which contain 
the name of the standard color files 
OS32: COLOR. DIR 

5 

LNMDIR 

S'J'DCOL 

The number of characters in the color 
directory name 

14 

MAXCOL 

STDCOL 

The maximum numlier of names of standard 
color files that can exist in the color 
directory 

200 

COLLUN 

STDCOL 

The logical unit number of color directory 

4 

VLTNO 

VLTDAT 

Video Lookup Table device number 

0 

UFLIM 

VLTDAT 

Last usable entry in the LVT. Entries 
above the UPLIM in the LVT have been 
rv^served for RAMTEK FIPP module usage 
such as storage of text color. 

UPLIM = VLT.I, - NRES 

2047 

VLTUP 

VLTDAT 

Flag for whether the VLT data has success- 
fully been loaded into the RAMTEK display 
device 

False 

BW 

VLTDAT 

Flag for whether the image displayed is 
black and white or color 

False 
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The user will then input the file name of the INTERDIVTA 7/32 

disc file wliich contains the standard color data needed for the j 

current image display. 

i 

QUERY 7 - COLOR INITIALIZATION-NO STANDAIUD COLOR FILE | 

If the information in the UNIVAC header record, word 52, indicates 
that a standard color file is not to be used with the current image 
display, then the IIGS will output the following query: 

DOES THE USER WANT TO USE A STANDARD COLOR FILE (Y or N)? 

The purpose of this query is to allov/ the user to override the 
standard color file flag in the RSIS UNIVAC header record if the 
user wants to. 

If the user does not want to use a color file, then he will input 

an "N" following query 7. If the user does want to use a standard ! 

color file, a "Y" will be input IIGS will output: ! 

ENTER NAME OF THE STANDARD COLOR FILE TO BE USED . 

FILE NAME = 

The user will then input the name of the desired standard color i 

file. 

QUERY 8 - LOADING COLOR ARR AY S IF THE INPUT FILE CONTAINS A B/W VLT 

The following query will be output only on the special occasion 

when the input RSIS CCT contains no color VLT record and does 

contain a B/W Video Lookup Table record and color/level records 

(see appendix A IIGS User's Guide records type 5 and 6). If this 

condition exists then, IIGS will output: 

A B/W VLT HAS BEEN LOADED INTO THE RAMTEK . 

DOES THE USER WANT TO BUILD AND LOAD A COLOR VLT FROM 
DATA IN ARIU\YS "COLOR" AND "LEVEL" (Y or N) ? 

The user wil3. input a "Y" i.f he wishes to load these color data 

values into the RAMTEK VLT for this special circumstances. If 

the user does not want to change the VLT, he will input an "N" 

following query 8. 
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Following the uner response to Query 7 or Query 8 if it is output, 
the IIGS wil] begin reeding the image records from the imago 
data file on the RSIS and transmitting the data to the RAMTEK 
for display. This process will continue until all data is 
displayed on the RAMTEK CRT, unless an error is encountered. The 
system will then output query/menu 9. 

QUERY 9 - USE R SELECTION OF ACTION TO RE DONE AFTER IMAGE DISPLAY 

Following the initial display of the image data on the CRT, the 
lies will output the follov:ing menu/query: 

ENTER NEXT ACTION CODE 

1 = CURSOR COORDINATES RIOQUIRED 

2 = COLOR TABLE REPORT/CMANGES REQUIRED 

3 = RE-STOIUD LAST SCENE ON DISPLAY CRT 

4 =; DISPLAY PROCESSING COMPLETE 

IF THE USICR WANTS TO CONTINUE CURRENT IMAGE ANALYSIS THEN 
MAKE NO ENTRY UNTIL ONE OF THE ABOVE ACTIONS IS REQUIRED. 

ACTION •- 

The user then performs an analysis on the image developed on the 
CRT. The user, upon completion of the initial analysis, will 
choose an action for IIGS from the above menu/query. 

QUERY 10 - ACTION = 1 - CURSOR COO R DINATES REQUIRED 

If the user inputs a "1" (one) following Query 9, then the IIGS 
will begin collecting cursor coordinates for the user. The IIGS 
will then output: 

RSIS CRT CURSOR COORDINATE REPORT 
THE IMAGE TITLE IS: < title > 

DOES THE USER WAN'3’ THE CURSOR COORDINATES OUTPUT TO A PRINT 
FILE (Y OR N)? 

If the user wants the CRT coordinates written to a tabulation disc 
file, then the user will input a "Y". The IIGS will then dynamically 
open a file named: "0S32 :CURSOR. DAT" . The file will receive all 

' cursor coordinates that the user has indicated he wants reported 
and all be available for outputting on the INTERDATA printer at a 
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later printing time. If the user does not want to store 
coordinates in a tabulation file, then the user will enter an 
"N" following the above query. Follov/ing the above input response, 
the IIGS will output; 

IS THE CURSOR POSITIONED TO THE POINT OF INTEREST (Y or N) ? 

The IIGS will then wait for the user to select a point on the 
RAMTEK CRT. The point is selected by the user positioning the 
cursor over a point of interest in the current image display. 

Once the user has positioned the cursor, he v^ill then input a 
''Y" response to the above query. The IIGS will then read the 
cursor coordinates from the RAMTEK and output the following; 

THE HORIZONTAL COORDINATE X (NNN) = XXX NNN = COORDINATE NUMBER 
THE VERTICAL COORDINATE Y (NNN) = XXX XXX = INTEGER NUMBER 

If the user has requested coordinates to be output to the print file, 
then these lines will also be output to the designated disc file. 
Following the above output, IIGS will then output; 

DOES THE USER WANT TO CONTINUE COORDINATE COLLECTING (Y or N) ? 

The user will input a "Y" response if more coordinates are to be 
output and the above query: 

IS THE CURSOR POSITIONED TO THE POINT OF INTEREST (Y or N) ? 

Will be output again. The user will again position the cursor and 
enter a "Y." The coordinates will be output following the "Y" input 
response. The user v;ill continue the above actions until all the 
required cursor coordinates have been reported. Upon completion of 
collecting and reporting the cursor coordinates, the user will input 
an "N" response following the query asking if more coordinates are 
to be collected. The IIGS will then output the action menu/query. 
Query 9, to allow the user to exercise one of the other action 
options supplied by the IIGS. 

QUERY 1,1 - ACTION - 2 COLOR TABLE REPORT /CHAN GES REQUIRE D 
If the viscr inputs a "2" (two) following Query 9, then the IIGS 
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will begin the color table report/color changing process. The 
color report is diagrammed on page 19 of the User's Guide. 

Upon entry of the "2", IIGS will output: 

IIGS COLOR REPORT 

COLOR REPORT IS BEING OUTPUT ON THE CRT - WAIT FOR THE NEXT 
MESSAGE . 

The IIGS will then clear the bottom portion of the RAMTEK CRT 
(the color report window on page 19 of the User's Guide) and 
begin outputting the current color table bar and the title 
information. If there are more than two, color bars will be 
output containing the current colors. IIGS v/ill never report 
more than 1024 colors. Upon displaying the color bar(s) on the 
RAMTEK CRT, IIGS will output: 

DOES THE USER WANT THE CURRENT COLOR TABLE OUTPUT TO A PRINT 
PILE (Y OR N)? 

If the user does not want tlie coloirs output in a tabular format 
to a disc file, theii the user will input, an "N" response. If 
the user does want to output the color information for the colors 
being currently used to display the image, data, then the user 
will input a "Y" response. 

If the user inputs a "Y" response, the IIGS will dynamically open 
a file named: "0S32 :COLOR .DAT" and the color table data will be 

written to this file. 

Following the above query, IIGS will output: 

DOES THE USER WANT TO CHANGE ANY COLORS IN THE EXISTING SCENE 
(Y OR N) ? 

If the user does not want to charge any colors, then the us.*??; 
will enter an "N". The IIGS will then output. the action 
menu/query. Query 9, and tlie user can take some other course 
, of action. 
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If the ufu;r vcinte to chaiujr? co2.ortj, ilion the user wiJ.l enter a 
"y" roBponno fo’.l!lowimj the abovcj quc’.ry. The TIGS will then 
output tlio rqHctrurn of colors ror color ehaii'-jes color bars and 
its associatetl sub-title. The IIGS will then output; 

DOI'JS Tlli:; U5JJ;R VJJ'.NT more CO], ore displayed in the spectrum of 
COLORS (Y or N)? 

If the u!'3or wants IIGS to display more than 128 colors, then the 
user wili input a "Y" resi^onsc. The IIGS v;ill then output a 
spectrum of color bars that contain 512 colors. If the user is 
scitisfied wiih t)ie original 128 color spcctruri, then the user 
will, input a "W" response following the previous query. 

The following is then output by the IIGS: 

DOES THE USER REQUIRE THE COliOR CHANGING PROCEDURE TO BE OUTPUT 
ON THE ALPHA- NUMERIC TJiRMIMAL (Y OR N)? 

If the usc'.r does not need instiuct.ions on the process of changing 
colors, then the uscor vrlll input an "N" following the above query. 
How’ever , i.t t he user needs the color changing procedure to be 
detailed then ho v/ill input a "Y" response and the IIGS v^ill then 
output i'.he foJlovving detailed instructions: 


RSIS COLOR CHANGING INSTRUCTIONS 


THERE ARE CUltRIlNTLY T'vtO SETS OF COLOR BARS BIAlNG DISPLAYED ON THE 
RAMTEK CRT. 'i'HE TOP SET OF BARS CONTAIN THE COLORS CURRENTLY 
BEING USED IN THE JMAO,E . TilJ''. BOTTOM SET OF BARS CONTAIN A SPECTRUM 
OF COLORS cirrcjl VAU.L 1 -iE used U'lJEN CH75.NGING THE PRESENT COLOR TABLE. 
THE USER IS TO SELECT THE CO], OR TO ]',E CHANGED BY POSITIONING THE 
CRT CTHtSOj] (Vvi-j'K eoi,OR TO I',E C:H7 CivG1';D ON THE TOP SET OF COLOR 

BARS iU'JD DLl'KJfSCnWG THE M.NTER" SV7ITC11 ON THE CURSOR CONTROLLER. 

THE USER MUS'j' THEN POSITION THE ClHtSOK OVElt THE COLOR THAT IS TO 
BE USED AS A .ACEMENT Cu;i,,OR ON THE BOTTOM SET’ OF COLOR BARS 
AND T)IEN TURN THE "ENTER" tHCrTCH ON. THE CHOOSEN COLOR WILL 
RE]‘'LACE THE Ot,D COLOR IN THE VIDEO l.OOKUP TABLE 

THE US]]R Wll,l, l'ONTINUE Till.: PROCESS DIRSCRIBED IN THE PREVIOUS 
PARAGUAIHI UNT.Tl, ALL COj,OR CHANCHNS HAVE BEEN MADE. WHEN THE USER 
IS SATISE'IJID VtlTH THE NJ'.W COi.OR SCHEME, THE USER MUST MOMENTARILY 
TURN THE "VISIBLE" SWITCH OFF. 
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The user than will follow the procedure described above. When 
the visible switch has momentarily been turned off, the IIGS 
will then output the action menu/query, Query 9, to allow the 
user to exercise one of the other actions detailed in Query 9. 

QUERY 12- AC T ION - 3 - RF.-STORE LAST SCENE ON DISPLAY CRT 

This action can only bo performed following action 2, color 
report./ change action. When action 2 was chosen, the IIGS wrote 
the image data that was in the color report window to a disc 
file. When the user exoi-ciso.s action B, than the user wants 
the stored data restored on the RAMTEK CRT. 

If the previous action code was not a "2" and the user enters 
a "3" following Query 9, than the IIGS will output: 

USER REQUIRED TO RESTORE LAST SCENE AND THE LAST SCENE IS STILL 
AVAILABLE. 

This message is output to inform the user that the IIGS has taken 
no action to re-store the scene as the scene is still intact on 
the CRT. The user has input tlio wrong action code. 

If the previous action code was a " 2 ", output of a color report, 
then the IIGS v/ill output the follov/ing if cclor changes have 
been made: 

DOES THE USER WANT THE ORIGINAL COLOR TABLE, PRIOR TO CHANGES, 
RJjISTORED (Y OR N) ? 

The above query will give the user the cnpabi.lity to display the 
image scene with the original colors if the user is not satisfied 
with the now color scliemc. If the user is satisfied with the 
new colors, then the user will enter "Y" aresponse. Othenv^ise, 
the user will input an "N" response. 

The IIGS will then restore the missing portion of the image that 
was saved when a color report was output. Upon completion of 
restoring the image scene the IIGS will output the action menu/query. 
Query 9. ... 






QUERY 13 - ACTION 4 


DISPLAY PROCESSING COMPLETE 


Once the usoi' is finished image analysis, and he does not want to 
exercise any of the other action options provided by Query 9, 
the user- will input a "4" four following Query 9. IIGS will 
output : 

USER HAS REQUESTED TEl^JINATION OF CURRENT DISPLAY. 

The completion process of the current execution (pass) of the 
IIGS will then begin. 

If the user inputs a response loss tlian 1 or greater than 4 
following Query 9, the IIGS will output Query 9 again in order 
that the user can enter a legal action code. 

QUERY 14 - FI L E SAVING 

Before the current pass in the IIGS is completed, the user is 
given the oi^tion to save the image file in an INTERDATA/RAMTEK 
compatible format and/or to save the colors currently being used 
in the image display in a standard color file stored on the 
INTERDATA 7/32 disc pack. The IIGS will output: 

ARE ANY FILES TO BE SAVED (Y or N) ? 

If the user does not want to save any files, then the user will 
input a “N" response following the above query and the rest of 
the queries noted in this section will be skipped. 

If the user wants to save one or both of the aforementioned files, 
then the user will input a "Y" response. IIGS will output: 

IS THE IMAGE DATA TO BE SAVED (Y or N) ? 

If the user wants the image data saved in an INTERDATA/RAMTEK 
, compatible format, then the user will input a "Y" response. 
Otherwise, the user will input an "N" response. If the user 
inputs a "Y" response, then IIGS will rev/ind and unload the CCT 
that is currently mounted on the INTERDATA tape drive. The 

IIGS will then output the following message: f;i'. 

OF PyOH 
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MOUNT A SCim'Cn TAPE ON THE INTERDATA TAPE DRIVE. 

WHEN READY TO CONTINUE ENTER A 1. 

When a scratch tape has been mounted and the user is ready to 
begin having the image data output to the CCT, the user will 
then input a "1" (one). The IIGS will then'output: 

THE TITLE OUTPUT ON THIS CCT IS: < title > 

The image data will then be written to the CCT and upon completion 
the IIGS will output: 

IF IMAGE PROCESSING IS TO CONTINUE MOUNT THE INPUT 
CCT ON THE INTERDATA TAPE DRIVE. 

WHEN READY TO CONTINUE ENTER A 1. 

The above will cause the IIGS processing to pause until the user 
has mounted an input CCT if IIGS is to perform another pass on 
another set of data. When the user is ready, he will input a 
*'l” (one) . 

The IIGS will then output: 

IS THE COLOR TABLE USED IN THE CURRENT IMAGE PROCESSING 
TO BE SAVED (Y or N) ? 

If the user does not want the color table output to a standard 
disc color file, the user will input an "N" response. 

If the usc5r does not want the color table data saved on a disc 
file, then the user will input a "Y" response. The IIGS will 
then output : 

FILE NAME = 

The user w'ill then input the name of the file that is to contain 
the current color table data. The IIGS will tlien begin to output 
the color table data to th^ named file. 

QUERY 15 - IIGS PROCESSING CONTINUATION/COMPLETION 

The following is the last query output in any pass in the IIGS; 
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IlCr. PROCESSING COMPLETE (Y or N) ? 

If all IIGS processing has been completed, then the user will 
input a "Y” response. The IIGS will then close all files and 
terminate processing on the INTERDATA 7/C2. 

If there is more image data to be processed, then the user will 
input an "N" response. The IIGS will then begin setting up for 
another pass through the IIGS software and Query 1 will be 
output again. 

3.2.2 INTERDATA/RAMTEK COMPATIBLE CCT PROCESSING 

The processing described in the following paragraph is the 
branch of IIGS processing performed when the input data is in 
an INTERDATA/RAMTEK compatible format as described in Appendix 
B of the User's Guide. Each query is numbered for documentation 
purposes. In actual operation of the IIGS the query numbers 
do not appear. 

QUERY 1 - BEG I N PROCESSIN G 

The IIGS begins processing image data by outputting the following 

RSI.S INTERIM INTERACTIVE GRAPHICS SUBSYSTEM 
INPUT DATA IN RSIS UNIVAC FORMAT (Y or N)? 

The IIGS outputs Query 1 in order to determine the proper 
processing branch to take. This sub-section of the user's guide 
deals with tlie non-standard form of input, an INTERDATA/RAMTEK 
compatible CCT. Therefore the user will input an "N" response 
to the above query. 

QUERY 15 - A SS URANCE OF TYPE OF INPUT 

The IIGS will begin the non-standard input processing and will 
output; 

INITIALIZE THE IIGS FOR PROCESSING DATA FROM A 
RAMTEK/INTERD7iTA COMPATIBLE FILE. 


ABBREVIATIONS ACRONYMS 


bpi 

CCT 

CRT 

CT 

DEC 

FIPP 

lies 

I/O 

LUN 

OS/32 

Pixel 

RGIS 

VLT 


Bytes per inch 
Computer Compatible Tape 
Cathode Ray Tube 
Computer Tomography 
Digital Equipment Corporation 
(RAI'ITEK) Fortran Image and Plot Package 
Interim Interactive Gi'aphics Subsystem 
I npu t /Ou t pu t 
Logical Unit Number 
Interdata 7/32 Operating System 
Picture Element 

Remote Sensing Information System 
Video Lookxip Table 


